home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / sunrpc / getrpcent.man < prev    next >
Encoding:
Text File  |  1990-12-03  |  3.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. GETRPCENT             C Library Procedures              GETRPCENT
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      getrpcent, getrpcbyname, getrpcbynumber - get RPC entry
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ##iinncclluuddee <<nneettddbb..hh>>
  13.  
  14.      ssttrruucctt rrppcceenntt **ggeettrrppcceenntt(())
  15.  
  16.      ssttrruucctt rrppcceenntt **ggeettrrppccbbyynnaammee((nnaammee))
  17.      cchhaarr **nnaammee;;
  18.  
  19.      ssttrruucctt rrppcceenntt **ggeettrrppccbbyynnuummbbeerr((nnuummbbeerr))
  20.      iinntt nnuummbbeerr;;
  21.  
  22.      sseettrrppcceenntt ((ssttaayyooppeenn))
  23.      iinntt ssttaayyooppeenn
  24.  
  25.      eennddrrppcceenntt (())
  26.  
  27. DDEESSCCRRIIPPTTIIOONN
  28.      ggeettrrppcceenntt, ggeettrrppccbbyynnaammee, and ggeettrrppccbbyynnuummbbeerr each return a
  29.      pointer to an object with the following structure containing
  30.      the broken-out fields of a line in the rpc program number
  31.      data base, //eettcc//rrppcc.
  32.  
  33.           ssttrruucctt    rrppcceenntt {{
  34.                cchhaarr **rr__nnaammee;;  //** nnaammee ooff sseerrvveerr ffoorr tthhiiss rrppcc pprrooggrraamm **//
  35.                cchhaarr ****rr__aalliiaasseess;;   //** aalliiaass lliisstt **//
  36.                lloonngg rr__nnuummbbeerr;; //** rrppcc pprrooggrraamm nnuummbbeerr **//
  37.           }};;
  38.  
  39.      The members of this structure are:
  40.           rr__nnaammee              The name of the server for this rpc
  41.                               program.
  42.           rr__aalliiaasseess           A zero terminated list of alternate
  43.                               names for the rpc program.
  44.           rr__nnuummbbeerr            The rpc program number for this
  45.                               service.
  46.  
  47.      ggeettrrppcceenntt reads the next line of the file, opening the file
  48.      if necessary.
  49.  
  50.      ggeettrrppcceenntt opens and rewinds the file.  If the _s_t_a_y_o_p_e_n flag
  51.      is non-zero, the net data base will not be closed after each
  52.      call to ggeettrrppcceenntt (either directly, or indirectly through
  53.      one of the other "getrpc" calls).
  54.  
  55.      eennddrrppcceenntt closes the file.
  56.  
  57.      ggeettrrppccbbyynnaammee and ggeettrrppccbbyynnuummbbeerr sequentially search from the
  58.      beginning of the file until a matching rpc program name or
  59.      program number is found, or until EOF is encountered.
  60.  
  61.  
  62.  
  63. Sprite v1.0              6 October 1987                         1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. GETRPCENT             C Library Procedures              GETRPCENT
  71.  
  72.  
  73.  
  74. FFIILLEESS
  75.      //eettcc//rrppcc
  76.  
  77. SSEEEE AALLSSOO
  78.      rrppcc(5), rrppcciinnffoo(8),
  79.  
  80. DDIIAAGGNNOOSSTTIICCSS
  81.      Null pointer ((00)) returned on EOF or error.
  82.  
  83. BBUUGGSS
  84.      All information is contained in a static area so it must be
  85.      copied if it is to be saved.
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0              6 October 1987                         2
  130.  
  131.  
  132.  
  133.